Monster Media 1996 #15/Monster Media Number 15 (Monster Media)(July 1996).ISO/pcboard/cbfree13.zip/CBCFG.SAM

Text File | 1996-06-08 | 18KB | 407 lines

3
PASS;3
3
E1Q0V1X4M1
45
60
202
301
00:00:00;00:00:00
17:01:00;05:00:00
0;C:\PCB\CBVMSG.DOC
TRUE
TRUE
FALSE
TRUE
.50
.25
.25
TRUE;FALSE;NMBR =;301;A;TRUE;PRIVATE
ATDT
,9;,444;D
1
NOTES
10
US
TRUE
'┌───────────────────────────────────────────────────────────────┐
'│ This is the main configuration file for the Callback program. │
'│ Each line is explained at the end of the file.  Comments are  │
'│ allowed within this file by starting a line with a (#) or (') │
'│                                                               │
'│ The configuration file MUST CONTAIN 26 CONFIGURATION OPTIONS  │
'│ OR THE PROGRAM WILL NOT RUN!!!!                               │
'└───────────────────────────────────────────────────────────────┘
'
'1 = HIGHEST security level allowed to use the PPE
'
'2 = USER/PASS/BOTH;verification entry tries
'
'    Parm A - USER = Verify by asking for the Username
'             PASS = Verify by asking for the Password
'             BOTH = Verify by asking for the Username and Password
'
'    Parm B - Number of times to allow user to attempt to
'             match verification string(s) (username, password).
'
'3 = Number of tries to call user.  Entries 16, 17, & 18 - subtract from
'                                                          this value until
'                                                          0 is reached
'4 = INIT string for modem
'
'5 = Timeout for Local callback (seconds)
'
'6 = Timeout for Long Distance callback (seconds)
'
'7 = Area Code which is ALWAYS a local call (*NEVER* Long Distance)
'    If area is code entered here the xxxXCHNG.DAT file is not required
'    for this area code.
'    NOTE: Blank line = no area codes are ALWAYS a local call.
'
'8 = When this area code is entered by the user and it is a local call,
'    callback will NOT use the area code as part of the number dialed.
'    For instance:  If 301 was entered here, then any LOCAL CALL to 301
'    would be dialed as XXX-XXXX and not 301-XXX-XXXX.  If you have a blank
'    line here, then all local calls will use the area code as part of the
'    number to dial.
'
'9 = Start time and end time to allow a local callback.  The format for
'    this entry is:  starttime;endtime.  Example:  7:00:00;23:00:00
'    If the current system time is not within the starting and ending
'    time, the file NOCALL will be displayed to the user explaining
'    that we do not do callbacks during this time, and show them the
'    times that we allow callbacks.
'
'    NOTE:  If this line is BLANK, then callbacks will be allowed 24hrs/day
'           to all local callbacks
'
'10= Start time and end time to allow a long distance callback.  The format for
'    this entry is:  starttime;endtime.  Example:  17:00:00;07:00:00
'    If the current system time is not within the starting and ending
'    time, the file NOCALL will be displayed to the user explaining
'    that we do not do callbacks during this time, and show them the
'    times that we allow callbacks.
'
'    NOTE:  If this line is BLANK, then callbacks will be allowed 24hrs/day
'           to all long distance callbacks
'
'    If you have "DISABLED" (no quotes) for this line, all Long Distance
'    callbacks will be blocked (not allowed).
'
'11= Conference number and path/filename of message to be imported when a
'    successful callback is completed.  A blank line DISABLES this function.
'
'    Entry #11 consists of TWO parameter.  Param A is the conference
'    number where you want a message posted when a callback is
'    successful (this message is only sent to the SysOp).  Param B is
'    the full path and filename of the message you wish to IMPORT into
'    the message base for the conference number listed as Parm A.  Here
'    are a couple of examples:
'
'    EX)  0;C:\PCB\CBSUCCES.DOC
'
'    EX)  6;C:\PCB\TEXT\CBMSG.DOC
'
'    In the first example, we will be using CONFERENCE 0 (Main) and
'    will post the message C:\PCB\CBSUCCES.DOC.
'
'    The message will be to  :  SYSOP
'    The message will be from:  CALLBACK PPE
'    The message subject     :  Username who completed Callback
'    The message text        :  (imported from your file CBSUCCES.DOC)
'    The message will be PRIVATE
'
'    And yet another example for you:
'    EX) 0;c:\dan\testmsg.doc  (post to conference "0" - Main)
'
'    I then did a local callback and viewed the message in conference
'    "0" as follows:
'
'   ┌───────────────────────────────────────────────────────────────────┐
'   │ Date: 04-21-96 (08:36)        Number: 3317 of 3317 (Refer# NONE)  │
'   │   To: SYSOP                                                       │
'   │ From: CB-FREE CALLBACK PPE                                        │
'   │ Subj: Dan Shore - Completed Callback                              │
'   │ Read: NO                       Status: RECEIVER ONLY              │
'   │ Conf: Main Board (0)           Read Type: GENERAL (R/O) (+)       │
'   │                                                                   │
'   │ Callback completed.                                               │
'   │                                                                   │
'   └───────────────────────────────────────────────────────────────────┘
'
'    I have a file in the c:\dan directory called TESTMSG.DOC with
'    a single line in it that has:  "Callback completed" (as you
'    can see above in the body of the message).  Note in the
'    subject, the users actual name appears to inform you "who"
'    completed the callback.
'
'12= Set TRUE or FALSE.  TRUE will display the prompt "Use Other Phone
'    Number" when the user is displayed their Data Phone Number and their
'    voice phone numbers from their user record to use as a callback
'    number.
'
'13= TRUE means check area code entered by user against area codes in
'    AREACODE.DAT file.  If area code is not found in AREACODE.DAT, then
'    the user is informed that it is an INVALID area code and exited from
'    the callback process.
'
'    FALSE means DO NOT check for the file AREACODE.DAT
'
'14= TRUE means check exchange entered by user and see if the file
'    "xxxXCHNG.DAT" exists (xxx is the area code entered by the user).
'    IF xxxXCHNG.DAT exists, check the exchange entered by the user
'    to see if it exists in the "xxxXCHNG.DAT" file.  If the exhcange
'    does exist, then the phone call is LOCAL.
'
'    FALSE means do not check for the existance of the "xxxXCHNG.DAT"
'    file and then the user will be prompted for the call being
'    LOCAL or LONG DISTANCE.
'
'    NOTE:  See CB.DOC for further explaination on xxxXCHNG.DAT files
'
'
'15= TRUE means to upgrade user to successful security level if their
'    name and phone number is already in VERIFIED.LOG (user has been
'    verified before).
'
'    FALSE means do not upgrade user, make them go through the callback
'    process again
'
'16= Value to deduct from configuration option line #3 (times to try
'    callback) when a BUSY is encountered
'
'17= Value to deduct from configuration option line #3 (times to try
'    callback) when a NO DIAL (no dialtone) is encountered
'
'18= Value to deduct from configuration option line #3 (times to try
'    callback) when a RING (incoming call) is encountered
'
'19= Caller ID Processing (5 parameters)
'
'    1st parameter = TRUE means to use the CALLER ID information as the
'    users callback number.  If this is FALSE, all other parameters for
'    this feature are ignored.
'
'    The 2nd parameter if TRUE means to automatically upgrade the user
'    if the caller ID information matches one of the entries in the user
'    record.  Otherwise a callback will be performed using the Caller ID
'    phone number.
'
'    The 3rd parameter is the string that starts the phone number in the
'    CID info.  Usually this is NMBR = , but with some modems it is
'    NUMBER:  If you are not sure, look in your PCBoard Callers file
'    for your CID info.  If you are only passing the phone number
'    to PCBoard, then leave this parameter with no value.  Here is an
'    example:  TRUE;TRUE;;301;A;TRUE;PRIVATE
'
'    The 4th parameter is when CID only returns a 7 digits phone number
'    (exchange and last 4).  When this occurs, this areacode is added to
'    the beginning of the CID information.
'
'    The 5th parameter is either an "A" or an "H".  This tell the PPE if
'    the phone number is in "A" = ASCII or "H" = HEX format in the CID.
'    If HEX, the PPE will convert it to an ASCII number when "H" is entered.
'
'    The 6th parameter is either TRUE or FALSE.  This parameter determines
'    if a user who is blocking CID information to be exited from the PPE or
'    allowed to continue the callback.  TRUE = Kick user out of the callback
'    due to the NMBR not containing the actual phone number but matches
'    the string in parameter #7. FALSE = User is blocking CID info, but
'    still let them go through the callback process.
'
'    The 7th parameter is the string to search for to determine if the
'    user is blocking CID information.  Typical strings to search for
'    are:  PRIVATE or BLOCKED.  Check with your local Phone Co. to see what
'    string/phrase is used when a user is blocking their CID info.
'
'    NOTE:  Some local phone companies allow you to stop any calls
'           where a user is blocking caller id.  This is stopped at
'           the central office and never reaches your BBS.  The user
'           will receive a recording informing them of the inability
'           to call the desired number with CID blocked.  Again,
'           check with your local phone company for this option.
'
'    NOTES about CID:
'    ────────────────
'
'    The CB LOG file will show if the CALLER ID information matches an
'    entry in the User Record, along with an entry in the PCB Callers
'    log
'
'    If the 1st parmameter is FALSE, the remaining paramters need not be entered.
'    If the 1st parameter is TRUE, you MUST USE parameters 2, 3, 4, 5, 6, & 7
'
'20= Modem Dial string (set to ATDT for touch tone or ATDP for dial pulse)
'
'21= Three part entry.
'
'     Part 1 = Dialing Prefix
'     Part 2 = Dialing Suffix
'     Part 3 = When to use suffix
'
'    Dialing prefix to add to phone number.  Some places require a number
'    in order to get an "outside" line.  If a number is entered here, it
'    will be added to the BEGINNING of the phone number.  For instance
'    if the number to call was 1-333-444-5555 and you had "9," as the
'    prefix string, the modem would be sent: 9,13334445555.
'
'    NOTE:  If you require a COMMA after the prefix, you MUST have this
'           as part of this entry.
'
'    Dialing suffix to add to phone number.  Some places require a number
'    in order to dial long distance.  If a number is entered here, it
'    will be added to the END of the phone number.  For instance
'    if the number to call was 1-333-444-5555 and you had ",4444" as the
'    suffix string, the modem would be sent: 13334445555,4444
'
'    NOTE:  If you require a COMMA, you MUST have this as part of this
'           entry.
'
'    When to use suffix:
'
'        "A" = All the time,
'        "D" = LD calls only
'        "L" = Local callsonly
'
'    A Blank line means do not add a special dialing strings
'
'22= This is the Long Distance prefix.  This number will be used when
'    making a LD phone call.  Normally in the U.S. you would use "1"
'    as the prefix but in some cases you will want to change this to
'    another number.  If you had "1" for this parameter and you were
'    calling 333-444-5555, the phone number dialed would be 13334445555
'    as the LD prefix would be added to the number.
'
'    The second parameter is REQUIRED when you are using BOTH as an
'    option for parameter #25 (Calling Allowed:  US, INTL, BOTH).
'    The option will be the long distance prefix for INTERNATIONAL
'    callbacks.
'
'    Example:       A;B            1;011
'
'    A = Long distance prefix for Non-International callbacks
'    B = Long distance prefix for International callbacks
'
'
'23= Option to add:  Date, Time, and Phone Number to COMMENT field
'    of NOTES field.  NOTE:  To use the NOTES field, you MUST HAVE
'    the PSA installed!!!  See your PCB manual for instructions on
'    installing the Notes PSA.
'
'    OPTIONS:  COMMENT, COMMENT1, COMMENT2, NOTES, BLANK LINE
'
'    COMMENT
'    ───────
'    The program will FIRST check to see if COMMENT Field #1 is used.
'    If #1 is used, the program will check to see if COMMENT Field #2 is
'    used.  If #2 is used, NO POSTING WILL BE DONE!
'
'    COMMENT1 -or- COMMENT2
'    ──────────────────────
'    If either of these options is chosen, the callback information will
'    be written to the selected COMMENT# field no matter if information
'    was already there or not.  (OVERWRITES PREVIOUS INFORMATION)
'
'    NOTES
'    ─────
'    If this option is chosen, the program will first check to see if the
'    PSA is installed.  If installed, the callback information will be
'    written to the notes field.  NOTE:  The information will only be
'    written to the NOTES fields IF THERE IS ROOM for the callback
'    information (30 characters).  If there is not enough room to write
'    the information (due to other information already there), NO CALLBACK
'    information will be written to the NOTES fields.
'
'    BLANK LINE
'    ──────────
'    Disable this feature.
'
'24= Minimum length of phone number to be valid.  A value of 10 is used
'    when the callback is for the U.S. or areas that use the three part
'    phone number (ac+ex+4)
'
'    An entry of 10 would
'    be used for US dialing: areacode + exchange + last 4  (3+3+4 = 10)
'
'    The program will check for this length, and abort if the length is
'    not equal to this value.  One place the program checks this value
'    is when processing phone numbers from the user record.  If the phone
'    number from the user record is used and the length is not equal to
'    this value the user will be PROMPTED for areacode, exchange, & the
'    last 4 numbers when using U.S. dialing (parameter #25 - see next).
'
'    The SysOp will be alerted in the log if the phone number does not
'    match this length.
'
'    The second parameter is REQUIRED when you are using INTL or BOTH
'    as an option for parameter #25.
'
'    Example:     A;B            10;9
'
'    A = Minimum phone length for US Calling plan Callbacks
'    B = Minimum phone length for INTL Calling plan Callbacks
'
'
'25= Callbacks allowed.  Accepted values:  US, INTL, BOTH
'
'    US     -  Use area code, exchange, last 4 for all
'              callbacks.  International calls are not
'              supported.
'
'              US dialing plan requires a value of 10 in the
'              first configuration option for entry number 24.
'
'  INTL     -  Use Country Code, City Code, and Last Numbers
'              for all callback.  International calls are
'              not supported
'
'  BOTH     -  Perform callback to BOTH area code/exchange/last4
'              and country code/city code/last numbers formats.
'              When the user first enters callback, they will be
'              asked what format their phone number is (PFORM1).
'              They will then be asked if the callback will be
'              and International callback.
'
'              If the callback is INTERNATIONAL, the second long distance
'              prefix parameter (CFG Param #22) will be used.  Also, the
'              second minimum phone number length parameter (CFG parm #24)
'              will be used.
'
'
' IMPORTANT NOTE!!!!  If you are using INTL or BOTH as the value for this
'                     parameter, you can use a SECOND option on the
'                     configuration line which enables the program to ask
'                     the user if the callback to them requires a leading
'                     ZERO to the phone number.  For instance in the U.K.
'                     a call to an exchange code of 181 is dialed 0181
'                     then the remaining part of the phone number.
'
'                     To enable this option, enter TRUE after the INTL or
'                     BOTH value.   Ex)  INTL;TRUE
'
'                                   Ex)  BOTH;TRUE
'
'                     With it set to TRUE a "0" will be added to the
'                     beginning of the phone number.
'
'                     If there is a better way of dealing with the leading
'                     zero instead of asking the user, please let me know.
'
'
'26= Hangup after a Long Distance Callback verification?
'
'    TRUE  = hangup on the user after a long distance callback
'    FALSE = let user stay on line (you pay for the rest of the call)
'
'    Anything but the word FALSE for this configuration option will
'    cause the program to disconnect after a successful long distance
'    callback.
'
'    WARNING - SETTING THIS OPTON TO FALSE MEANS YOU WILL BE PAYING
'              THE PHONE BILL FOR THE ENTIRE TIME THE USER IS ON YOUR
'              BBS AFTER THE CALLBACK IS COMPLETED!!!!  YOU HAVE TO
'              PAY!!!!! USE THIS FEATURE WITH EXTREME CAUTION!!!!!
'
'    Information will be posted in the LOG file and the CALLERS log IF
'    THE USER IS ALLOWED TO STAY ONLINE AFTER LD CALLBACK.